From f7e927b93c83b3e1b8956a490f67a8820923db52 Mon Sep 17 00:00:00 2001
From: Matthias Clasen <mclasen@redhat.com>
Date: Fri, 22 Jul 2011 21:54:08 -0400
Subject: [PATCH] Try to make the docs build again

After some searching, it turns out that gtk-doc now interprets
markdown, and can no longer accept '-' in the docs without making
a mess. I hope that this does not affect more places in more
subtle ways.
---
 gtk/gtkfilechooserdialog.c | 55 +++++++++++++-------------------------
 1 file changed, 19 insertions(+), 36 deletions(-)

diff --git a/gtk/gtkfilechooserdialog.c b/gtk/gtkfilechooserdialog.c
index 6e7cdc105a..de61afdc2d 100644
--- a/gtk/gtkfilechooserdialog.c
+++ b/gtk/gtkfilechooserdialog.c
@@ -113,40 +113,23 @@
  * <section id="gtkfilechooserdialog-setting-up">
  * <title>Setting up a file chooser dialog</title>
  * There are various cases in which you may need to use a #GtkFileChooserDialog:
- * <itemizedlist>
- *   <listitem>
- *     <para>
- *       To select a file for opening, as for a
- *       <guimenuitem>File/Open</guimenuitem> command.  Use
- *       #GTK_FILE_CHOOSER_ACTION_OPEN.
- *     </para>
- *   </listitem>
- *
- *   <listitem>
- *     <para>
- *       To save a file for the first time, as for a
- *       <guimenuitem>File/Save</guimenuitem> command.  Use
- *       #GTK_FILE_CHOOSER_ACTION_SAVE, and suggest a name such as
- *       "Untitled" with gtk_file_chooser_set_current_name().
- *     </para>
- *   </listitem>
- *
- *   <listitem>
- *     <para>
- *       To save a file under a different name, as for a
- *       <guimenuitem>File/Save As</guimenuitem> command.  Use
- *       #GTK_FILE_CHOOSER_ACTION_SAVE, and set the existing filename
- *       with gtk_file_chooser_set_filename().
- *     </para>
- *   </listitem>
- *
- *   <listitem>
- *     <para>
- *        To choose a folder instead of a file.  Use
- *        #GTK_FILE_CHOOSER_ACTION_SELECT_FOLDER.
- *     </para>
- *   </listitem>
- * </itemizedlist>
+ * <itemizedlist><listitem>To select a file for opening, as for a
+ *   <guimenuitem>File/Open</guimenuitem> command.  Use
+ *   #GTK_FILE_CHOOSER_ACTION_OPEN.
+ * </listitem>
+ * <listitem>To save a file for the first time, as for a
+ *   <guimenuitem>File/Save</guimenuitem> command.  Use
+ *   #GTK_FILE_CHOOSER_ACTION_SAVE, and suggest a name such as
+ *   "Untitled" with gtk_file_chooser_set_current_name().
+ * </listitem>
+ * <listitem>To save a file under a different name, as for a
+ *   <guimenuitem>File/Save As</guimenuitem> command.  Use
+ *   #GTK_FILE_CHOOSER_ACTION_SAVE, and set the existing filename
+ *   with gtk_file_chooser_set_filename().
+ * </listitem>
+ * <listitem>To choose a folder instead of a file.  Use
+ *   #GTK_FILE_CHOOSER_ACTION_SELECT_FOLDER.
+ * </listitem></itemizedlist>
  * <note>
  * <para>
  * Old versions of the file chooser's documentation suggested
@@ -156,8 +139,8 @@
  * considered to be a good policy, as now the file chooser is
  * able to make good suggestions on its own.  In general, you
  * should only cause the file chooser to show a specific folder
- * when it is appropriate to use gtk_file_chooser_set_filename()
- * - i.e. when you are doing a <guimenuitem>File/Save
+ * when it is appropriate to use gtk_file_chooser_set_filename(),
+ * i.e. when you are doing a <guimenuitem>File/Save
  * As</guimenuitem> command <emphasis>and</emphasis> you already
  * have a file saved somewhere.
  * </para>
-- 
2.30.2